home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr41 / cds55.zip / CDS.DOC next >
Text File  |  1994-11-28  |  57KB  |  1,100 lines
  1.                               CD SCAN Version 5.5
  2.                                      demo
  3.                             Copyright (c) 1992-1994
  4.                                       By
  5.                               Joseph K. S. Dunn.
  6.  
  7.                              All rights reserved.
  8.  
  9.                                   USER MANUAL
  10.                                28 November 1994
  11.                                    Contents
  12. Chapter                                                                   Page
  13.  
  14. Acknowledgments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  15.  
  16. Foreword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  17.  
  18. Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  19.  
  20. Copyright Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  21.  
  22. Registering Cd Scan. . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  23.  
  24. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  25.  
  26. 1. Installation and System Requirements. . . . . . . . . . . . . . . . . .   6
  27.  
  28. 2. Starting the Program. . . . . . . . . . . . . . . . . . . . . . . . . .   7
  29.  
  30. 2.1. Getting Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  31.  
  32. 3. Entering a New Cd . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  33.  
  34. 3.1. Editing Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  35.  
  36. 3.2. Some brief notes. . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  37.  
  38. 4. Exiting Cd Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  39.  
  40. 4.1. Command Prompt. . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  41.  
  42. 5. Browsing Your Cd Collection . . . . . . . . . . . . . . . . . . . . . .  11
  43.  
  44. 5.1. Browse Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  45.  
  46. 5.2. Re-sorting the Index. . . . . . . . . . . . . . . . . . . . . . . . .  12
  47.  
  48. 6. Displaying a Cd . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  49.  
  50. 6.1. Display Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  51.  
  52. 6.2. Editing a Cd. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  53.  
  54. 6.2.1. Edit Options. . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  55.  
  56. 6.3. Deleting a Cd . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  57.  
  58. 6.4. Tagging and Pasting Tracks. . . . . . . . . . . . . . . . . . . . . .  14
  59.  
  60. 6.5. Creating and Viewing Lyrics . . . . . . . . . . . . . . . . . . . . .  16
  61.  
  62. 6.5.1. Printing Lyrics . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  63.  
  64. 6.6. Summary of Display Symbols. . . . . . . . . . . . . . . . . . . . . .  17
  65.  
  66. 7. Exporting Data  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  67.  
  68. 8. Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  69.  
  70. 9. Print Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  71.  
  72. 9.1. Print Main Cd Index . . . . . . . . . . . . . . . . . . . . . . . . .  20
  73.  
  74. 9.2. Print All Cds . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  75.  
  76. 9.3. Print Cd Comments . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  77.  
  78. 9.4. Edit Text File. . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  79.  
  80. 9.5. Print Text File . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  81.  
  82. 9.6. Printer Control . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  83.  
  84. 9.7. Notes about Printing. . . . . . . . . . . . . . . . . . . . . . . . .  21
  85.  
  86. 10. Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  87.  
  88. 10.1. Optimising the Data File . . . . . . . . . . . . . . . . . . . . . .  22
  89.  
  90. 10.2. Undeleting Cds . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  91.  
  92. 10.3. Merging Catalogues . . . . . . . . . . . . . . . . . . . . . . . . .  23
  93.  
  94. 10.4. Select Colour Scheme . . . . . . . . . . . . . . . . . . . . . . . .  23
  95.  
  96. 10.5. Calculating Statistics . . . . . . . . . . . . . . . . . . . . . . .  24
  97.  
  98. 10.6. Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  99.  
  100. 10.7. Restoring From a Backup. . . . . . . . . . . . . . . . . . . . . . .  24
  101.  
  102. 11. Errors and Troubleshooting . . . . . . . . . . . . . . . . . . . . . .  24
  103.  
  104.  
  105.  
  106.                                 Acknowledgments
  107.  
  108. Special thanks to:
  109. - The Lord Jesus Christ who is my Inspiration and saviour, to whom I owe
  110.      everything. (Galatians 2:20)
  111. - To my family for their support and patience,
  112. - To Rohan Lewis and Tony Galliford for suggestions, help with the mouse
  113.      routines and testing of previous versions.
  114. - To Florence Golingai, Leon Foote and Ben Pikl for testing this version of Cd
  115.      Scan.
  116. - To Florence Golingai, Eufracia Villanueva and Susie Rasiah for proof reading
  117.      this edition of the manual. 
  118. - To you for choosing this software.
  119.  
  120. IBM is a registered trademark of International Business  Machines Corporation.                                    Foreword
  121.  
  122. This project has taken over three years of hard work to complete. Though I
  123. believe that quality software shouldn't be too expensive, I don't believe in
  124. giving it away either. The price you pay for things in life determines the
  125. value placed on them. If you like Cd Scan and find it useful, please register
  126. it, see Registering Cd Scan for details on how to obtain a fully functional
  127. version.
  128.  
  129. A bit about me: I am a blind student studying at The Flinders University of
  130. South Australia. I hope to complete my B.Sc. degree and major in Computer
  131. Science and use this as a basis to go on writing software to aid the disabled.
  132.  
  133. I enjoy listening to music, playing drums, singing, walking, programming and
  134. just being with friends. I believe that anyone is capable of achieving
  135. anything they put their mind to, provided they look to The creator for the
  136. purpose to life. Fulfilment is found in the Lord Jesus Christ and in the truth
  137. He both taught and lived. Once subject to His Lordship, all barriers in life
  138. are merely psychological. I can do all things through Christ who strengthens
  139. me (Philippians 4:13). He has provided salvation for mankind, (John 3:16-21,
  140. 3:36, 6:35-40, 14:6, Romans 1:16-21, 3:23, 6:23, 10:9-13), Revelation 20:15,
  141. He has provided peace to those who will hear Him (John 14:27), He has provided
  142. assurance of this salvation (1 John 5:11-12, John 14:1-4), He has provided all
  143. we need to survive (1 Corinthians 10:13, James 1:5, Philippians 4:19, Psalm
  144. 37:4, Matthew 6:25-34, Romans 8:28-39), He cares about every need
  145. (1 Peter 5:7, Matthew 11:28-30, Philippians 4:6-8 ...) and He is in the
  146. perfect position to do all of these things because of His perfect knowledge of
  147. us (Psalm 139, Isaiah 45:21-25, Romans 11:33-36).
  148.  
  149.                                   Disclaimer
  150.  
  151. I Joseph Dunn, the author of Cd Scan, will not be made liable, under any
  152. circumstance, regarding the use or inability to use this software. I will not
  153. be made liable for any loss of data or loss of profits even if I am notified
  154. of the possibility of such an event. This software comes as is, you use it at
  155. your own risk. I have tested this program as extensively as time has permitted
  156. and found it to perform as documented in this Manual. If you do find a bug in
  157. the program, please report it. I will do my best to fix any bugs submitted to
  158. me in writing.
  159.  
  160.                                Copyright Notice
  161.  
  162. The demo version of Cd Scan may be freely copied provided that the original
  163. files are not added to, deleted from or modified in any way. The registered
  164. version of Cd Scan is copyright and its documentation should be consulted for
  165. the terms relating to that version.
  166.  
  167.                               Registering Cd Scan
  168.  
  169. To obtain a fully functional version of Cd Scan which accommodates 4000 cds,
  170. each containing upto 99 tracks, instead of the limited 20 cds and 10 tracks
  171. per cd accommodated on this demo, please send a cheque or money order of $100
  172. Australian to the author at the address below, (include a clear mailing
  173. address and preferred disk size): 
  174.    
  175. Joseph Dunn:
  176.  
  177. 1/58 Murray Terrace,
  178. Oaklands Park S.A. 5046
  179. Australia
  180.  
  181. Phone: +61 8 296-3899                                  Introduction
  182.  
  183. Cd Scan is a powerful music cataloguing system specifically designed for
  184. cataloguing a compact disc collection. Up to 4000 cds each containing up to 99
  185. tracks may be accommodated on the Registered version. This demo is restricted
  186. to only 20 cds each containing upto only 10 tracks. To obtain the fully
  187. functional registered version, see the section Registering Cd Scan. The
  188. program includes a powerful and flexible search facility and a quick scan
  189. browse facility which allows you to quickly browse through your collection.
  190. The index may be sorted by the artist name, cd title or a unique id code at
  191. the press of a key. A cd's contents may be displayed, and you may even browse
  192. the lyrics of a given track if they exist, or jump into your favourite text
  193. editor automatically to add them if they do not. The print facility allows you
  194. to create title or artist lists as well as a complete record of your whole
  195. catalogue and much more. These lists may be printed directly or exported to
  196. your favourite word processor for further editing. 
  197.  
  198. Preparation of recorded material is made easy by Cd Scan's ability to
  199. accumulate selected track times and generate a list of these selections, which
  200. perhaps could be used as a cassette label.
  201.  
  202. A Utilities Menu offers maintenance features like Optimisation to ensure the
  203. most efficient access to your cd collection, an option to recover deleted cds,
  204. a facility to merge two catalogues together, the ability to select a different
  205. colour scheme and a function to calculate some statistics about your
  206. collection like average track time etc. For your peace of mind, you can also
  207. backup your valuable data files without leaving the program.
  208.  
  209. You may also "lock" Cd Scan so that if you are using it in a library or other
  210. public display, data may be protected from unauthorised modification. 
  211.  
  212. Besides Cd Scan's powerful features to make cataloguing your cds enjoyable and
  213. efficient, the program will also do its best to protect your data. Cd scan
  214. will automatically detect a missing or corrupt index and will attempt to
  215. rectify the situation, if it is ever needed.
  216.  
  217. To ensure that you get the most out of this cataloguing system, the User
  218. Manual may be called up from any of the menus at the press of a key (or the
  219. click of a mouse button).
  220.  
  221.                     1. Installation and System Requirements
  222.  
  223. To run Cd Scan you need an IBM compatible with at least 384k ram and DOS 2.11
  224. or later. If you intend to use Cd Scan near full capacity, 640k is required. A
  225. hard disk is recommended for fastest and most reliable performance. Cd Scan is
  226. distributed on a single floppy disk. The files on this disk should be placed
  227. in a directory by themselves. For the uninitiated, a directory is a place on
  228. the disk which contains files belonging to a particular group, i.e. all these
  229. files belong to Cd Scan and therefore should be placed in an area by
  230. themselves to distinguish their function from say your word processor files.
  231. To make a directory and place Cd Scan into it do the following:
  232.  
  233. 1.  Exit any application you may be running and get to the DOS prompt. It may
  234.      look something like:
  235.      C>
  236. 2.  From this point type:
  237.      CD\
  238.      (after pressing Enter) type:
  239.      MD CD-SCAN
  240.      (after pressing Enter), type:
  241.      CD\CD-SCAN
  242.      (and press Enter again).
  243. 3.  Place the disk with the Cd Scan files on it into drive A and type:
  244.      COPY A:\*.*
  245.      then press Enter again.
  246. 4. Once you have been returned to the DOS prompt, you may run Cd Scan by
  247.      typing the command:
  248.      CDS
  249.  
  250. See your DOS manual about creating batch files if you wish to run Cd Scan from
  251. a batch file or see the appropriate documentation if you wish to run Cd Scan
  252. from a menu program.
  253.  
  254. Any lyrics files are assumed to reside in a subdirectory of cd-scan called
  255. lyrics. To create this subdirectory, make sure you are in the cd-scan
  256. directory by typing:
  257.      cd\cd-scan (followed by Enter)
  258. then to create the directory type:
  259.      md lyrics (followed by Enter).
  260.  
  261. To use an editor to create or edit lyrics files from within Cd Scan you will
  262. need to set an environment variable to point to the editor. You can do this
  263. from the DOS prompt or include the command in your autoexec.bat file so that
  264. the variable is set automatically each time you boot your computer. Use the
  265. set command to set the cdsed variable to specify the drive, path and name of
  266. your editor. The command should look similar to the following:
  267. set cdsed=c:\utils\editor.exe
  268. See section 6.5 for more information about creating, editing or viewing lyrics
  269. files.
  270.  
  271.                             2. Starting the Program
  272.  
  273. To start Cd Scan, just type the command, cds, followed by enter from the DOS
  274. prompt. If you are not in the cd-scan directory, and if this directory is not
  275. in your path, you will have to change to it by typing: cd\cd-scan, first. A
  276. basic knowledge of DOS is assumed, if you have problems, consult a friend or
  277. the DOS Manual. You may wish to start the program from a menu system such as a
  278. Shell program, see the relevant documentation for the installation procedure. 
  279.  
  280. Cd Scan provides a mode of operation suitable for a public library, to prevent
  281. unauthorised modification of data. To run Cd Scan in "Locked" mode, add the -l
  282. command line option. In "Locked" mode, you will not be permitted to modify any
  283. data whatsoever.
  284.  
  285. Run Cd Scan by typing the appropriate command, e.g. cds -l, or by choosing it
  286. from your menu system.
  287.  
  288. Your screen will clear and a menu box will appear in the middle of your screen
  289. with the option "3 Browse Cd Index" highlighted. By pressing the up and down
  290. cursor keys, or by using a mouse to point to an option and pressing the left
  291. button once you can move the highlight bar to any of the seven options. To
  292. select an option, either press the left mouse button again or press Enter.
  293. Alternatively, you can press the number next to the option to highlight it and
  294. select it in one go. To cancel an option at any time, press the Escape key or
  295. the right mouse button. Options may be selected from sub-menus in the same way
  296. as the Main Menu, the first option of each sub-menu will return you to the
  297. Main Menu as will the Escape key or right mouse button. (Options such as
  298. Utilities Menu are examples of sub-menus).
  299.  
  300.                                2.1. Getting Help
  301.  
  302. Most of the instructions you need to operate the program will be displayed on
  303. the Status Line (the last line on the screen).
  304.  
  305. You may view the User Manual by pressing the F1 key or by clicking the left
  306. mouse button while pointing to the message "Press F1 for User Manual". 
  307.  
  308. While viewing the User Manual with Cd Scan's built in text file viewer, you
  309. may search for a particular Key-word by pressing F2 and typing the text to be
  310. located. 
  311. After pressing Enter, the cursor will be located at the beginning of the text
  312. if it is located. The search facility in the file viewer is case sensitive,
  313. i.e. uppercase and lowercase characters are different. To locate the next
  314. match, just press F2 followed by Enter. To exit the User Manual, press Escape
  315. or click the left mouse button while pointing to the esc-exit message. You
  316. will be returned to the Menu from which you invoked the User Manual. 
  317.  
  318.  
  319.                              3. Entering a New Cd
  320.  
  321. Well, lets get the show on the road! Lets begin by entering a compact disc
  322. into the system. Select "Enter a New Cd" by using the mouse or keyboard as
  323. discussed in the previous section. Cd Scan keeps track of several items of
  324. information about your cds. These are: The Artist, Title, Unique
  325. Identification Code (used when accessing lyric files), Track times, Track
  326. names, and a short comment about the cd. If a cd contains various artists
  327. (such as many compilation cds), these may also be recorded.
  328.  
  329. The first item you will be asked for is the Artist's name. If you are
  330. cataloguing a various artist cd, just enter a # as the artist's name. This
  331. tells the program to prompt you for the artist of each track. After you have
  332. typed in the Artist's name and pressed the Enter key, (as in all cases of data
  333. entry), Cd Scan will then respond with a prompt asking you to type the Title
  334. of the cd. If you make a mistake during the entry of data and don't realise it
  335. in time to correct it, i.e. you've pressed Enter, don't worry, you can correct
  336. it later. (see 6.2). You will then be asked to enter a unique id for the cd.
  337. You may accept a default id which is generated by Cd Scan at this stage by
  338. just pressing ENTER or ESCAPE, or you may enter your personal coding scheme. I
  339. use a scheme which gives each artist a number and for each disk by that
  340. artist, a letter, i.e. the first disk I purchased had the code 01a, the second
  341. by the same artist had the code 01b etc. After you have typed in the id of the
  342. cd and pressed ENTER, Cd Scan will check the uniqueness of this code. If it is
  343. found in the index, you will be asked to "try again".
  344.  
  345. Next, the screen will display a box with three columns in it and the artist
  346. and title centred above the box. This box will become familiar to you as you
  347. use the program. This screen will be referred to as the "Display Screen". The
  348. three columns are the track number (1 to 99), the time (mm:ss) and the track
  349. name. You will be asked to Enter the second two pieces of information, i.e.
  350. the track duration and name. If you don't wish to enter a time in, leave it
  351. blank by just pressing Enter.
  352.  
  353. If you specified that the cd contained various artists by entering a # at the
  354. first prompt, you will also be prompted for the artist of each track. If you
  355. leave this field blank, Cd Scan will record it as "NONE SPECIFIED".
  356.  
  357. Once all the tracks have been entered in, press Enter on a name field and you
  358. will be asked to type in a comment for the cd. If you don't wish to include a
  359. comment then just press Enter until the box disappears or press the Escape
  360. key. Such information which might be included in the comment box could be the
  361. copyright date, a favourite song or a music category etc. Once the data for a
  362. cd has been entered, the program will store the cd on disk and add its
  363. reference to the index. A Various Artist cd will be denoted by "VARIOUS
  364. ARTISTS" when browsing the index (See chapter 5). Cd Scan will automatically
  365. sort the index each time an addition is made.
  366.  
  367. To add lyrics for tracks entered, see section 6.5.
  368.  
  369.                                3.1. Editing Keys
  370.  
  371. When entering any data, the following keys may be used:
  372. - Left and Right arrow keys: move cursor left or right one space,
  373. - Backspace: move the cursor one space to the left and delete the character
  374.      there,
  375. - Delete: delete the character at the current cursor position,
  376. - Ctrl-w: delete to end of word,
  377. - Ctrl-l: kill line (in comment box only),
  378. - Ctrl-y: yank back line (in comment box only),
  379. - Home and End: move the cursor to the first or last character in the field,
  380. - Insert: toggle between insert or over-strike mode,
  381. - Enter/Tab: give completed data to program,
  382. - Escape: quit operation.
  383.  
  384.                              3.2. Some brief notes
  385.  
  386. 1. The cursor is the flashing square which appears when you are asked for a
  387.      response and which indicates where the next character will be placed on
  388.      the screen.
  389.  
  390. 2. Insert mode is where characters typed are inserted before other characters
  391.      on the line rather than over the top of them as in over-strike.
  392.  
  393. 3. You will notice that all characters typed will be converted to uppercase.
  394.      This feature standardises all data as many publishing companies can't
  395.      make up their minds about how the information on cd covers should be
  396.      printed. If all text is in one case it is faster to search through.
  397.  
  398. 4. The time for a track must be entered in the form mmss (you may omit leading
  399.      zeros, i.e. 355 is the same as 0355 and 50 is the same as 0050. If you
  400.      press Enter on a time field it will be left blank. Some cds don't have a
  401.      record of the track times.
  402.  
  403. 5. Text fields may be up to 60 characters in length and the comment may be up
  404.      to 5 lines of 60 characters. When entering or editing a comment, Word
  405.      Wrap will allow you to make full use of the space provided without you
  406.      having to calculate remaining space on each line. As you type, words
  407.      which cannot fit on the current line are automatically shifted to the
  408.      next line until the comment box is full.
  409.  
  410. 6. When entering filenames etc, moving the cursor with the arrow keys or
  411.      home/end before typing any characters will enable you to edit the default
  412.      response. If you just start typing, the default response will be replaced
  413.      by the new characters.
  414.  
  415. 7. The left mouse button is interpreted as the Enter key in the context of
  416.      editing or accepting default responses such as in filename prompts. The
  417.      right mouse button is interpreted as the Escape key at all relevant
  418.      times. For all (y/n) prompts, the right mouse button is equivalent to a
  419.      negative response, i.e. pressing "n" or the Escape key, while the left
  420.      button is equivalent to a positive response, i.e. pressing "y".
  421.  
  422.  
  423.                               4. Exiting Cd Scan
  424.  
  425. If you have had enough for this session and wish to Leave the program, you may
  426. select this option from the main menu or just press the Escape key or right
  427. mouse button until you are asked if this is your real intention. If you press
  428. Escape again, the operation will be cancelled and you will not exit the
  429. program. If you answer y for yes or hit the left mouse button you will leave
  430. Cd Scan and return to DOS or your menu system.
  431.  
  432. It is important that you exit Cd Scan properly before turning your computer
  433. off or data may be lost.( Choose this option rather than Command Prompt when
  434. you wish to use another Application Program or Turn your computer off).  
  435.  
  436.                               4.1. Command Prompt
  437.  
  438. Choosing this option allows you to go to DOS without actually quitting Cd
  439. Scan. It temporarily suspends the operation of the program allowing you to
  440. enter DOS commands. To return to Cd Scan, just type exit. Do not type cds
  441. again or you will effectively have two copies of the program running. If Cd
  442. Scan is locked or there is insufficient memory to start a new instance of
  443. COMMAND.COM which may be the case if you are running the program near full
  444. capacity, selecting this option will just immediately return you to Cd Scan.
  445.  
  446.  
  447.                         5. Browsing Your Cd Collection
  448.  
  449. Once the index contains at least one cd you will be able to browse. Select
  450. Browse from the main menu and two boxes will be displayed, the number of cds
  451. in the index will be written above these boxes and the bottom line (status
  452. line) will display several options.
  453.  
  454. The two boxes (or windows) contain a list of artist names and cd titles. A
  455. highlight bar will appear marking an artist and title. The cd's unique id
  456. code, if it has one, will be displayed in the top right corner of the screen.
  457.  
  458. Note:     the cd highlighted will be referred to as the current cd.
  459.  
  460. As you highlight a cd, its id code (if it has one) will be displayed in the
  461. top right corner of the screen. You may go straight to a particular cd by
  462. using the "go to" option. To select this option either press the F2 key or use
  463. the mouse to point to it and click the left button. You will be asked to enter
  464. a cd id code. If this code is located, the cd with that code will become the
  465. current cd.
  466.  
  467. To exit the Browse facility, just press the Escape key or the right mouse
  468. button.
  469.  
  470.                                5.1. Browse Keys
  471.  
  472. You may browse through the cds using the following keys:
  473.  
  474. - Up/Down: move the highlight bars up or down one cd,
  475. - Pgup/Pgdn: move the bars forward or backward a page at a time,
  476. - Home/End: move the bars to the first or last cd in the index.
  477. - Tab: change sort order from artist to title to id code.
  478. - F2: go to cd with a particular id code.
  479. - Escape: return to the main menu.
  480.  
  481. You may also use the mouse to point to a cd and press the left button to
  482. highlight it. To display the previous or next screen of cds using the mouse,
  483. point to the top or bottom border of the windows and press the left button.
  484.  
  485.                            5.2. Re-sorting the Index
  486.  
  487. When you press the Tab key or press the left mouse button wile pointing to the
  488. "tab-reorder" message on the status line, the index will be re-sorted.
  489. Initially, the index is sorted by the artist's name. The first time you press
  490. the tab key the two windows containing the artist names and titles will be
  491. swapped and the index re-sorted by the cd titles. The next time you press the
  492. tab key the index will be sorted by the unique id codes. A third press of the
  493. tab key will return the index to its initial state of being sorted by the
  494. artist names. The highlight bar will be placed on the same cd in its new
  495. sorted position in the index. When you exit the browse screen, if Cd Scan is
  496. not "Locked", the sort order will be remembered for the next time you browse
  497. your collection. This doesn't apply if you are browsing the results of a
  498. search.
  499.  
  500.  
  501.                               6. Displaying a Cd
  502.  
  503. If you press Enter on the current cd or press the left mouse button while
  504. pointing to the highlighted cd, the familiar box first encountered in the
  505. "Enter a New Cd" option along with several other items will be displayed. The
  506. first time of the first track will be highlighted. This highlight bar
  507. indicates the current track.
  508.  
  509. If the cd contains various artists, the usual position for the cd artist will
  510. be replaced by the artist of each track as you scroll through the tracks. The
  511. words "VARIOUS ARTISTS" will appear above this.
  512.  
  513.                                6.1. Display Keys
  514.  
  515. You may move this highlight bar to particular tracks using the following keys:
  516.  
  517.  
  518. - Up/Down: move to next or previous track,
  519. - Pgup/Pgdn: move to the previous or next screen of tracks, 
  520. - Home/End: move to the first or last track on the cd.
  521. - F2/F3: goto next/previous matching track or cd. 
  522.  
  523. You can also use the mouse to highlight a time by pointing to the track and
  524. pressing the left mouse button.
  525.  
  526.                                6.2. Editing a Cd
  527.  
  528. Cd scan allows you to edit the contents of a cd. This is useful if you find
  529. that you've mistyped a name or if you missed some information. You are even
  530. permitted to Reorder the tracks just in case they were printed on the cd cover
  531. in a different order to what they were actually recorded on the cd. This
  532. option also allows you to add tracks that may have inadvertently been left off
  533. when you initially entered the cd.
  534.  
  535. The edit options are accessed by pressing Alt-e or by pressing the left mouse
  536. button while pointing to the option on the status line. 
  537.  
  538. If Cd Scan is not "Locked", pressing Alt-e or selecting this option with the
  539. mouse will display options corresponding to the field names that can be edited
  540. and the options of reordering and adding tracks.
  541.  
  542.                               6.2.1. Edit Options
  543.  
  544. You may select:
  545. a - to correct the artist's name,
  546. t - for the title of the cd,
  547. i - for the id code,
  548. n - for the current track name,
  549. c - for the comment,
  550. d - for the duration (length) of the current track,
  551. l - to add or edit the lyrics of the current track (see 6.5),
  552. r - to reorder the tracks,
  553. m - to add more tracks.
  554.  
  555. Remember you can also make a selection using the mouse. Once a selection is
  556. made, you are permitted to edit the selected field.
  557.  
  558. You will not be permitted to delete either the title, main artist or Id code
  559. of the cd, only edit them. If you attempt to delete these fields, they will
  560. just miraculously reappear when you press Enter. 
  561.  
  562. If the cd contains various artists then selecting "a" for artist will allow
  563. you to edit the artist of the highlighted track.
  564.  
  565. If you delete all the characters when editing the name of a track, you will be
  566. asked if you really want to delete the track. According to your response, the
  567. appropriate action will be taken. If you delete the track, all other tracks
  568. will be moved up one position. If you delete all the tracks on the cd then the
  569. empty cd will be deleted from the index and obviously irrecoverable.
  570.  
  571. To reorder the tracks, simply highlight the track you wish to move using the
  572. keyboard or mouse, select the edit options, select reorder, then highlight the
  573. track before which you want to insert, finally, press Enter or press the left
  574. mouse button on the highlighted track. The initial track will be inserted
  575. before the second track you selected and the rest of the tracks will be
  576. shifted appropriately.
  577.  
  578. You may add tracks to a cd by selecting m. A cd may contain up to 99 tracks.
  579.  
  580. See section 6.5 for information about adding or editing Lyrics for tracks.
  581.  
  582. When you return to the browse screen by pressing Escape or display the next or
  583. previous cd using F2 or F3, the changes will be written to disk. The index
  584. will be re-sorted if need be only when you exit the browse screen. This means
  585. that if you edit the artist, title or id code of a cd which causes it to take
  586. a different position in the index, the cd will not be moved until you exit the
  587. browse screen and go back in to it.
  588.  
  589.                               6.3. Deleting a Cd
  590.  
  591. If you wish to delete a cd from the catalogue, you can do this from the browse
  592. screen. Just make the cd you wish to delete the current one, i.e. highlight
  593. it, then either press Alt+d or use the mouse to point to the option and press
  594. the left button as usual. If Cd Scan is not "Locked", you will be asked if you
  595. really want to go ahead with the deletion and then according to your response,
  596. the appropriate action will be taken. (Don't worry if you delete a cd
  597. accidentally, you will be able to undelete it later from the Utilities Menu.)
  598.  
  599.                         6.4. Tagging and Pasting Tracks
  600.  
  601. Once you have a cd displayed on the screen, you may use Cd Scan's functions to
  602. help you compile a radio program, create a tape label or just create a list of
  603. your favourite tracks from your collection.
  604.  
  605. The tag function may be viewed like the Program facility offered on most Cd
  606. Players. If you tag a track, it is marked for pasting to a text file and its
  607. time is added to the Total Time Box. You may unmark the track and subtract its
  608. time just by tagging the track again. Alternatively, if you wish to create a
  609. label containing all but one or two tracks, you only need mark those two
  610. tracks and then use the Invert function to invert the status of all the tracks
  611. on this cd, i.e. unmark all marked tracks and mark all unmarked tracks and add
  612. the time of just the marked tracks to the Total Time Box.
  613.  
  614. To mark a track and add its time to the Total Time Box, simply make the track
  615. the current one by highlighting it and then press the Space Bar. To unmark and
  616. subtract this track's time, just press the Space Bar again. To perform a tag
  617. invert, just press and hold down the Alt key and press the Space Bar. As
  618. described above, the status of all the tracks will be inverted.
  619.  
  620. The tag facility is also selectable via the mouse as usual.
  621. This facility allows the text of the track number, time, name and possibly
  622. artist, to be added to a text file for later printing or editing. A "+" or "*"
  623. will be placed in the right margin to indicate that a track has been tagged
  624. for pasting, depending on whether the track also has a lyrics file linked to
  625. it. When you use the Invert function (Alt-Space), you will notice the
  626. indicator symbols (see 6.6) change to reflect the new status of each track.
  627. When you exit this screen and return to the browse index or display the next
  628. or previous cd using F2 or F3, you will be asked to enter a filename. A
  629. default name will be offered, either accept this name or edit the field to
  630. change it. The artist's name, cd title and all tagged tracks will be added to
  631. this file. To edit this file you must use a text editor of some sort, although
  632. you can print it as it is from the Print Menu.
  633.  
  634. If this file is not deleted, it will be added to each time you Paste a track
  635. to it. You are given the option to delete this file from the "Print Text File"
  636. option on the Print Menu. 
  637.  
  638. Times will be accumulated as different cds are displayed. To clear the time
  639. box and unmark all tracks on the displayed cd, press the Delete (Del) key.
  640.  
  641. Note:     Times will not be accumulated above 99:59. If an attempt is made to
  642. add times that total more than this, or to subtract times until total is less
  643. than 0 then an error message will alert you. The Time box must then be cleared
  644. using Del.
  645.  
  646. Play with this tag function and practice tagging tracks and creating text
  647. files of your favourite songs. Remember you may even select another cd by
  648. pressing F2 or F3 or by returning to the browse screen by pressing Escape and
  649. selecting another cd. Notice that the time box is not cleared. Make sure you
  650. clear the time box if you just want the total of one cd.
  651.  
  652.                        6.5. Creating and Viewing Lyrics
  653.  
  654. Cd Scan allows you to add lyrics to any track and thus be able to view them
  655. just by selecting the track. To add or edit lyrics, do the following:
  656.  
  657. 1.   Cd Scan requires you to set an environment variable to specify the
  658.      location and name of the text editor you wish to use. You can do this
  659.      from the DOS prompt or include the command in your autoexec.bat file so
  660.      that the variable is set automatically each time you boot your computer.
  661.      Use the set command to set the cdsed variable to specify the drive, path
  662.      and name of your editor. The command should look similar to the
  663.      following:
  664. set cdsed=c:\utils\editor.exe
  665.  
  666. 2.   From the display screen, make the track for which you want to add or edit
  667.      lyrics current, i.e. highlight it.
  668.  
  669. 3.   Press Alt-e followed by l, and the editor specified by the environment
  670.      variable will be invoked with the lyrics file. If lyrics do not currently
  671.      exist for the specified track, a new file will be created with the track
  672.      name, artist and cd title automatically entered. Cd Scan assumes that
  673.      your editor takes a single command line argument which is the name of the
  674.      file to edit.
  675.  
  676. 4.   Type in the lyrics to the given track and save the file as you normally
  677.      would.
  678.  
  679. 5.   Exit your editor and you will automatically be returned to Cd Scan's
  680.      display screen. An indicator symbol will appear in the right margin to
  681.      tell you that this track now has lyrics linked to it.
  682.  
  683.  
  684. Once you have the lyrics to any of the tracks in your collection entered, you
  685. may display them just by selecting the track, i.e. press Enter after
  686. highlighting it. (of course you can just double click the left mouse button
  687. while pointing to the track).
  688.  
  689. You may also use a word-processor to create lyrics files. A file must be saved
  690. as ASCII text in the lyrics subdirectory under the name of idtk.lyr where id
  691. is the unique cd identifier and tk is the track number, e.g. if the disk id is
  692. 01a and the track is 1 then the file should be called 01a01.lyr. If you use an
  693. external word-processor to create lyrics as just mentioned, you should
  694. optimise your catalogue and relink tracks and lyrics so that Cd Scan will
  695. correctly identify your new lyrics file. (see 10.1). 
  696.  
  697. When a lyrics file is displayed you may use the following keys to move through
  698. it: up/down, pgup/pgdn, home/end. You may search for text by pressing F2 and
  699. typing the pattern to be located. After you have entered the search pattern
  700. and pressed Enter, the cursor will be placed at the start of the pattern if it
  701. is located. This search facility is case sensitive, i.e. the case of the
  702. characters typed in must match the characters in the text exactly if a match
  703. is to be found. To locate the next match, just press F2 followed by Enter. To
  704. exit the file viewer, press the Escape key. This file viewer will enable you
  705. to view any strictly text document of up to 64k in size.
  706.  
  707. An attempt to display a nonexistent lyrics file will result in an error
  708. message.
  709.  
  710. When you optimise the catalogue, you will be given the option to update any
  711. links to lyrics files, in case new lyrics have been added or files have been
  712. deleted.
  713.  
  714. If you re-order the tracks on the cd, the program will automatically check to
  715. see if there are lyrics files which need to be renamed and perform the
  716. appropriate housekeeping. If you delete a track, its lyrics file will be
  717. renamed with the "old" extension and the subsequent tracks will be renamed as
  718. appropriate. If you edit the cd's id and change it, all lyrics files linked to
  719. that cd will automatically be renamed. If a cd is deleted, no action is taken
  720. with regard to its lyrics files if they exist.
  721.  
  722.                             6.5.1. Printing Lyrics
  723.  
  724. You can print the lyrics to a track just by pressing Alt+p (or clicking the
  725. left mouse button while pointing to the "Alt+p-print" message) while viewing
  726. the lyrics on the screen. You will be asked to align the paper in the printer
  727. after which you must press a key to start printing. Make sure the printer is
  728. correctly connected, switched on, loaded with paper and correctly aligned to
  729. avoid annoying errors.
  730.  
  731.                         6.6. Summary of Display Symbols
  732.  
  733. Symbols appearing in the right margin while displaying a cd indicate a track's
  734. status as follows:
  735.  
  736. A blank indicates that this track has no lyrics file,
  737. An "X" indicates that this track has a lyrics file,
  738. A "+" indicates that this track will be pasted to a text file on exit from the
  739. Display Screen,
  740. A "*" indicates that this track has a lyrics file and will be pasted to a text
  741. file on exit from the Display Screen.
  742.  
  743.                               7. Exporting Data 
  744.  
  745. Besides being able to export text for printing or editing, you can export part
  746. or all of your catalogue to a set of Merge (*.MRG) files to be incorporated in
  747. another catalogue.
  748.  
  749. To do this, from the browse screen (option 3 from the Main menu or as a result
  750. of a search), press Alt+x (or select it with the mouse in the usual way). You
  751. will be asked to enter the drive and path to save the Merge Files to. Type the
  752. drive and path, e.g. A:\ and press Enter. Two files, CDS5.MRG and CDS5NDX.MRG
  753. will be created. (You must include the trailing Backslash character in the
  754. path specification, as in D:\TEMP\)
  755.  
  756. This facility is useful if you wish to share cd data without having to re-
  757. enter it. You can, for instance, search for all the cds by White Heart and
  758. export them so that other White Heart fans don't have to type in all the
  759. information on these cds.
  760.  
  761. See section 10.3 for information about incorporating these files into another
  762. catalogue.
  763.  
  764.  
  765.                                  8. Searching
  766.  
  767. Cd Scan allows you to search for any part of any field in the catalogue except
  768. the id. Select "Search Menu" from the Main Menu and you will be given the
  769. options of searching the different fields. Select the field you wish to search
  770. and enter the text to be located. The text may appear anywhere in the field.
  771.  
  772. If you select Artist, all various artist cds will also be searched. 
  773.  
  774. Selecting the "Track Length" field allows you to either search for all tracks
  775. which are a specific length, which are in a range of lengths, less than a
  776. given length or longer than a given length.
  777.  
  778. Here are some examples of how track length searches are entered:
  779.  
  780. 1. 233 - search for all cds containing tracks exactly 02:33 in length.
  781. 2. <30 - search for all cds containing tracks of length < 30 seconds.
  782. 3. >1000 - search for all cds containing tracks with length > 10 minutes.
  783. 4. 233-302 - search for all cds containing tracks whose lengths are in the
  784.      range 02:33 to 03:02 inclusive.
  785.  
  786. An example of entering a time specification is given on the status line when
  787. you choose this option.
  788.  
  789. Note:     Searching by artist or title will be significantly faster as these
  790. fields are held in memory.
  791.  
  792. If you select the option to search for all tracks which have a Lyrics File
  793. attached to them, you can quickly and easily locate the lyrics of a particular
  794. track without having to browse through the whole catalogue.
  795.  
  796. Once the search has taken place, you will be presented with a secondary Search
  797. Results Menu. From this menu you can view the search results, print or create
  798. text files of the search results or calculate statistics on all cds located
  799. during the search.
  800.  
  801. If you select the View Search Index option, the results will be presented in
  802. the same form as the browse screen. See chapters 5 and 6. When you display a
  803. cd after being presented with a list of cds containing matches, the first
  804. matching track will be highlighted if appropriate. To jump to the next
  805. matching track, press F2 or use the mouse; to jump to the previous matching
  806. track, press F3 or use the mouse. This facility will only be relevant if you
  807. searched by either Track Name or Track Length or if the cd has various artists
  808. and you've searched by Artist Name.
  809.  
  810. If you select any of the Print options from the Search Results Menu, you will
  811. be able to export the search results in several formats to either a file or to
  812. a printer directly. The three print options are similar to those on the print
  813. menu for printing the cd index, all cd data or a comment summary, however,
  814. these options only print the results of the search just performed. (See
  815. section 9.1-9.3 for information about the more general versions of these
  816. options available from the Print Menu.)
  817.  
  818. The final option on the Search Results Menu will calculate some statistics on
  819. the search results. The statistics will be presented in a similar table to
  820. that mentioned in section 10.5 except that only the cds located during the
  821. search will be included. 
  822.  
  823.  
  824.                                  9. Print Menu
  825.  
  826. Printing is very useful because it gets the words out of the computer's grubby
  827. hands and onto paper like we are all used to. The print facility offers you
  828. the options of printing an artist list containing a list of artist names and
  829. titles, a full compact disc list containing all the information you entered
  830. and a summary just containing Titles, Artists, Id codes and Comments.
  831.  
  832. Any lists that are generated may be sent to a file or to any printer connected
  833. to the Parallel (LPT1) port. (Actually, if lists are sent to the printer, the
  834. DOS device name PRN and STDLIST are used).
  835.  
  836. You may invoke a text editor to add further comments before printing a file,
  837. and of course, you can print the file and send control codes to the printer.
  838.  
  839.                            9.1. Print Main Cd Index
  840.  
  841. Selecting this option will print a list containing the artist names and titles
  842. of all your cds. When you select this option, you will be asked to enter the
  843. name of the output file or device. If you wish to send the list to the
  844. printer, just accept the default name, otherwise, enter a valid filename to
  845. create. This file may then be imported into a text editor for further editing.
  846.  
  847. The list will be printed in a similar form and in the same order as the browse
  848. presentation, i.e. if your index is sorted by cd title then the cd titles will
  849. be in the left column otherwise the artist names will be in the left column.
  850. Titles or Artist names of more than 39 characters will be truncated. The pages
  851. will be automatically numbered and a heading printed at the top of each page.
  852.  
  853.                               9.2. Print All Cds
  854.  
  855. Selecting this option will print a full listing of all your cds, i.e. each cd
  856. will be listed in the order specified by the browse presentation. All the
  857. information will be printed including the comments. Pages will be
  858. automatically numbered and a heading will be printed at the top of each page.
  859. If a cd must be split across a page boundary, a continuation message is
  860. printed after restating the title of the continued cd.
  861.  
  862. When you select this option, you will be asked to enter the name of the output
  863. file or device. If you wish to send the list to the printer, just accept the
  864. default name, otherwise, enter a valid filename to create. This file may then
  865. be imported into a text editor for further editing.
  866.  
  867.                             9.3. Print Cd Comments
  868.  
  869. This option generates a summary of your catalogue containing the Artist name,
  870. cd title, id code and comments.
  871.  
  872. When you select this option, you will be asked to enter the name of the output
  873. file or device. If you wish to send the list to the printer, just accept the
  874. default name, otherwise, enter a valid filename to create. This file may then
  875. be imported into a text editor for further editing.
  876.  
  877.                               9.4. Edit Text File
  878.  
  879. If you have set the CDSED environment variable discussed in a previous
  880. section, you may invoke this editor on any file you specify. The CDSED
  881. variable is set from the DOS prompt to point to the path and name of the
  882. editor. The command would look something like SET CDSED=C:\UTILS\EDITOR.EXE.
  883.  
  884. If you select this option, you will be asked to enter a file to edit. Cd Scan
  885. assumes that the editor takes the file name as the command line argument, i.e.
  886. after you enter the file to edit, it is passed as a parameter to your editor.
  887.  
  888. On exit from your editor, you will be returned to the Print menu.
  889.  
  890. If you are using Cd Scan in locked mode then it is wise to use an editor which
  891. doesn't allow you to shell to DOS, otherwise the lock will not protect access
  892. to data. A Shell to DOS option in your editor's menu may be called Push to DOS
  893. or Command Prompt. Consult your editor's documentation.
  894.  
  895.                              9.5. Print Text File
  896.  
  897. If you used the Paste Track facility discussed in section 6.4 then you may
  898. print the text file created by selecting this option. If you select "Text
  899. File", you will be asked for the filename and offered a default name. Either
  900. select this name or edit it to change it. After printing this file, you will
  901. be asked if you wish to delete it. If you respond affirmatively, the file will
  902. be deleted and any subsequent pastes will be written to a new file. If you
  903. respond negatively or just press Escape, the file will be left intact and any
  904. subsequent pastes will be appended to the end of the old file.
  905.  
  906.                              9.6. Printer Control
  907.  
  908. When you select this option, you will be prompted to enter codes to send to
  909. the printer. You will need to refer to your printer's documentation to
  910. determine what codes to send. Once you know what control codes to send, the
  911. characters can be generated by holding down the Alt key and pressing the
  912. corresponding number on the numeric keypad. For example, to send a Formfeed
  913. character, control code 12, hold down the Alt key and type 12 on the numeric
  914. keypad then press Enter. You will be asked if you want to send the string and
  915. according to your response an attempt is made to send the string to the
  916. printer. This facility is useful for setting up your printer for say a tape
  917. label for which compressed print is appropriate. If you have trouble
  918. generating the characters with the numeric keypad, check the state of your
  919. Numlock key (it should be on).
  920.  
  921.                            9.7. Notes about Printing
  922.  
  923. 1. The print facility assumes you are using A4 paper and prints 60 lines to a
  924.      page.
  925. 2. A printer error will result if you attempt to print without paper or if the
  926.      printer is off-line. Press a key when you have fixed the problem or press
  927.      Escape to cancel printing.
  928.  
  929.                               10. Utilities Menu
  930.  
  931. This menu offers such facilities as optimisation, undeletion, merging, colour
  932. scheme selection, statistical analysis and backup.
  933.  
  934. Note:     If Cd Scan is "Locked" then the only valid options will be Select
  935. Colour Scheme, Calculate Statistics and Backup. Also, the Colour Scheme will
  936. not be remembered when you next use the program.
  937.  
  938.                         10.1. Optimising the Data File
  939.  
  940. Note:     If you wish to undelete any cds, this must be done before Optimise
  941. is selected, see 10.2.
  942.  
  943. Before I discuss what Optimisation does, you need to understand a bit about
  944. the way Cd Scan stores its information. I mentioned earlier about an index
  945. file, a file containing a list of reference pointers to the main text. The
  946. index file is generally the file which undergoes the most modification when
  947. adding or modifying data. In fact, when a cd is deleted, its reference pointer
  948. is just removed from the index and placed in a special deletion tracking file
  949. allowing undeletion which will be discussed soon. The information stored in
  950. the main data file is not modified in any way, this eliminates the possibility
  951. of disk error and minimises disk operations. When a cd is modified, a new copy
  952. of the cd is added to the end of the data file and the old pointer in the
  953. index is updated to point to the new copy. After many modifications have been
  954. made, the speed of the program may be affected. This is where Optimisation
  955. comes in.
  956.  
  957. What Optimisation does is reads each cd from the index and writes a new copy
  958. of the data file, writing the cds in their correct alphabetic order and
  959. eliminating obsolete data. Optimisation need only be performed when many
  960. modifications have been made. Optimisation also gives you the option of
  961. updating links to lyrics files which may have been added or deleted. 
  962.  
  963. When Optimise is selected from the Utilities Menu you will be asked if you
  964. wish to update links to lyrics files during the operation. Choosing to update
  965. these links will cause the optimise process to take a little longer. Before
  966. the optimisation begins, a backup of the catalogue is automatically made. You
  967. must not disturb the disk activity in any way until the Optimisation is
  968. complete or data may be lost and irrecoverable.
  969.  
  970. Note:     With a large catalogue, an XT type computer or a floppy disk system
  971. may take a while to perform the Optimisation. Please be patient and don't
  972. disrupt the operation.
  973.  
  974. After Optimisation has finished, searching and browsing will be more efficient
  975. and the main data file will probably be smaller. If something does go wrong
  976. during Optimisation the old files which were renamed with the "bak" extension
  977. may be renamed with the "dat" extension and the old catalogue restored. See
  978. your DOS manual with regard to renaming files. Installing a Disk Cache such as
  979. SMARTDRV.EXE, which comes with DOS, will speed up optimisation significantly. 
  980.  
  981.                              10.2. Undeleting Cds
  982.  
  983. If you accidentally deleted a cd or you just decide that you want back a cd
  984. which has been deleted, and if you haven't Optimised the catalogue, you may
  985. Undelete it. When "Undelete Cds" is selected from the Utilities Menu an
  986. attempt to locate a deletion tracking file is made. If found, you will be
  987. asked if you wish to undelete any cds contained in this file. If you undelete
  988. the cds at this point they will be added to the index again and will be
  989. accessible. If you choose not to undelete the cds at this point and decide to
  990. Optimise the catalogue they will be lost forever as the obsolete data will be
  991. removed from the main data file. (obsolete data includes deleted cds or old
  992. copies of a cd which have since been modified). The Deletion Tracking File
  993. DELETED.DAT will be deleted when the catalogue is Optimised.
  994.  
  995. Note:     If you undelete a cd, remember to check its id code as Cd Scan will
  996. not verify its uniqueness.
  997.  
  998.                            10.3. Merging Catalogues
  999.  
  1000. This facility allows two catalogues to be merged into one. If you know someone
  1001. who has already catalogued some cds which you have obtained and don't wish to
  1002. re-type all of the details, you may incorporate those cds into your own
  1003. catalogue.
  1004.  
  1005. When you select this option, you will be asked to enter the Drive and Path of
  1006. the Merge Files. To Merge from the TEMP directory on drive D, type D:\TEMP\
  1007. (you must include the trailing backslash). If the files are found, the data
  1008. contained in them will be merged into your catalogue.
  1009.  
  1010. Note:     Remember to check the id codes of the merged cds as Cd Scan will not
  1011. verify their uniqueness. 
  1012.  
  1013.                           10.4. Select Colour Scheme
  1014.  
  1015. This option will cycle through 4 colour schemes, one is suitable for a
  1016. monochrome monitor or a lap-top, the others are just varying colour schemes.
  1017. Once you have selected the desired scheme, it will be remembered the next time
  1018. you use the program, that is, unless the catalogue is locked.
  1019.  
  1020.                          10.5. Calculating Statistics
  1021.  
  1022. When you select this option from the Utilities Menu, Cd Scan will go away and
  1023. calculate some information about your cd collection. (All the vital statistics
  1024. you just were dying to know about and which will cure your insomnia, at least
  1025. for tonight). The following information will be presented in a table:
  1026.  
  1027.      minimum, average (mean) and maximum track length, minimum, mean and
  1028.      maximum cd length, minimum, mean and maximum number of tracks per
  1029.      cd, number of cds in index, total number of tracks, number of tracks
  1030.      with lyrics files and approximate playing time.
  1031.  
  1032.                                  10.6. Backup
  1033.  
  1034. This option will make a backup of your catalogue files to a specified
  1035. location. You will be asked to Enter the Drive and Path to write the backup
  1036. data to. To backup your catalogue on drive b: in the Back directory, type
  1037. B:\BACK\ (remember the trailing backslash). 
  1038.  
  1039. The two data files maintained by Cd Scan will be copied from their current
  1040. location to the new location and their extension will be changed to BAK.
  1041.  
  1042.                          10.7. Restoring From a Backup
  1043.  
  1044. If you ever need to restore your catalogue from a backup, just locate the disk
  1045. with the backup files and copy them into your CD-SCAN directory as follows.
  1046. (Assuming your backup files are on drive A in the Root directory)
  1047.  
  1048. COPY A:\CDS5.BAK C:\CD-SCAN\CDS5.DAT
  1049. COPY A:\CDS5NDX.BAK C:\CD-SCAN\CDS5NDX.DAT
  1050.  
  1051. If DOS asks if you wish to overwrite existing files, respond with y for yes.
  1052. (If you type these commands from the DOS Command Prompt in Cd Scan, you must
  1053. exit Cd Scan properly and restart it to load the restored data see chapter 4).
  1054.  
  1055.  
  1056.                         11. Errors and Troubleshooting
  1057.  
  1058. If Cd Scan does not run correctly, check the following:
  1059.  
  1060. 1. Your CONFIG.SYS file contains at least 20 files and buffers. (See your DOS
  1061.      manual for more information)
  1062. 2. Your cds5ndx.dat and cds5.dat files are both present in the same directory
  1063.      as the cds.exe file.
  1064. 3. If Cd Scan runs too slow, try Optimising it. If you have several thousand
  1065.      cds, Cd Scan will operate significantly slower than with a smaller
  1066.      catalogue.
  1067. 4. If your system locks up on start up, check how much memory your system has
  1068.      free. You may have to remove a device driver or other memory resident
  1069.      program.
  1070. 5. When the index is either empty or full, you will be notified. If full, no
  1071.      more cds may be added and if empty, there will be no data to search,
  1072.      browse or print.
  1073. 6. A printer error can usually be rectified just by ensuring that the printer
  1074.      is on line and that the paper is correctly aligned. If you still have
  1075.      trouble printing, consult your printer manual.
  1076. 7. Note on Deletion: The deletion tracking file, created when a cd is deleted,
  1077.      is called deleted.dat. Do not delete or modify this file or you will not
  1078.      be able to undelete any cds. Do not try to undelete a cd from an obsolete
  1079.      deletion tracking file as its reference may not be valid. Suffice to say,
  1080.      don't try to do the programs work for it or you may find yourself in
  1081.      trouble!
  1082. 8. When Cd Scan is "Locked" via the -l command line option, the message
  1083.      "Access denied" will be displayed when any attempt is made to modify
  1084.      data.
  1085. 9. Be sure to set the cdsed environment variable before running Cd Scan if you
  1086.      plan to edit or add lyrics files to any tracks from within the program.
  1087.      (see section 6.5). If you do not set this variable correctly, you may get
  1088.      the message "File not found" when you try to use the editor. Be sure to
  1089.      correctly specify the drive, path and name of the editor. You cannot use
  1090.      the MSDOS editor, edit.com, because it requires qbasic.exe which uses too
  1091.      much memory.
  1092. 10. If a lyric file is not found when you select a track, check that you have
  1093.      correctly named the file and that the cd has the id you think it should.
  1094.      If a cd has no id, Cd Scan will just look for a file with the track
  1095.      number and extension "lyr" as its name.
  1096. 11. The file viewer is strictly for text, it will convert any non-printable
  1097.      characters to spaces.
  1098.  
  1099.                                     THE END
  1100.